home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac 1993 September / September 93.iso / Archives / Utilities / Text / Caesura ƒ / Caesura Cuts Up... next >
Encoding:
Text File  |  1992-05-29  |  6.5 KB  |  170 lines  |  [TEXT/Rich]
  1. Understanding Caesura
  2.  
  3. version 1.0.0
  4.  
  5. © 1992 by Greg Swann
  6.  
  7. 5/29/92
  8.  
  9.  
  10. Greg Swann
  11. CompuServe: 70640,1574
  12. USPS: P.O. Box 1724
  13. Andover, MA 01810
  14.  
  15.  
  16.  
  17. First the important stuff: Caesura is pronounced "sez you're a"; I
  18. leave it to you to decide "a what"... It's Latin, meaning "to cut",
  19. and if you listen closely you can hear the word "scissors" in there.
  20.  
  21. Now the trivia: what does this do?
  22.  
  23. Caesura cuts, which is not a long leap. It cuts files of type 'TEXT'
  24. into chunks that are more manageable or more useful. I'd like to say
  25. that it's the most useful of my utilities, but I know this is untrue.
  26. Caesura exists to fulfill a need you will have infrequently. But when
  27. you _do_ have that need, it will do the job quickly and cleanly,
  28. without a lot of painful hacking away in a text editor.
  29.  
  30. I expect that you'll find that Caesura works best in conjunction with
  31. XP8 and Torquemada, two other utilites of mine. In particular,
  32. Caesura can be helpful in reducing the complexity (and hence running
  33. time) of Torquemada sets.
  34.  
  35.  
  36.  
  37. Commercial, legal and other pertinent notices:
  38.  
  39. XP8 is a text file reformatter. It will clean up and make
  40. QuarkXPress-ready Macintosh or DOS text files. Among many other
  41. features, it intelligently reformats paragraphs, converts the DOS or
  42. WordStar character sets to their Mac equivalents, substantially
  43. improves the hyphenation and justification of text, converts quotes
  44. better than any software currently available, and traps for XPress
  45. Tags errors that might otherwise result in missing text or
  46. irreversible document corruption. A semi-inhibited shareware version
  47. of XP8 is available on CompuServe (GO DTPFORUM, Library 5) and other
  48. electronic information services. The full commercial release can be
  49. obtained from Greg Swann at:
  50.  
  51. P.O. Box 1724
  52. Andover, MA 01810
  53.  
  54. Licenses are sold per machine, with a single license costing $50;
  55. 2-10 licences are $45 each; and 11 or more licenses are $40 each.
  56.  
  57. Torquemada is a batch search and replace utility. It employs a suite
  58. of 29 wildcards to run up to 640 searches on up to 128 files of type
  59. 'TEXT'. Torquemada is freeware in its current release. Torquemada 2.0
  60. will be a commercial release, and it will be priced in the same range
  61. as is XP8.
  62.  
  63. Caesura is freeware now, and will be forever and always.
  64.  
  65. Caesura is delivered "as is", without any warranties, expressed or
  66. implied. It is not warranted to be useful _to_ anyone, _for_
  67. anything, and in no wise am I to be held responsible for any
  68. unfortunate consequences resulting from its use or misuse. And I
  69. _hate_ having to say things like that. I do my best to write useful,
  70. simple, elegant, bug-free solutions to difficult problems. In this
  71. case, I am giving of my labor at no charge at all. If you take it
  72. into your head that I represent your big chance to 'strike it rich,'
  73. you will pay a lot in legal fees to discover that you have
  74. miscalculated. It's sad and sick and stupid that we live in a world
  75. of bloodsuckers, but I _promise_ I will not be leech lunch. So there!
  76.  
  77. And: to those to whom the above disclaimer does not apply: forgive me
  78. for having to make it. It's _you_ whom I'm working for, for pay or
  79. for free. I appreciate your custom and your support, and I wish we
  80. all could just comb the others out of our hair...
  81.  
  82.  
  83.  
  84. Using Caesura
  85.  
  86. Caesura is very straightforward in operation. There is but one dialog
  87. box. In that box is space to define a STRING LITERAL that STARTS A
  88. PARAGRAPH. Where that string literal is found, the source file will
  89. cut, as directed by the radio button group below.
  90.  
  91. A 'string literal' is actual readable text, without any wildcards. It
  92. must match the source file exactly, and case is sensitive. In
  93. consequence, the best way to define this string is by Pasting from
  94. your source file.
  95.  
  96. The string literal must live at the very start of a paragraph in the
  97. source file. We are not searching 'through' paragraphs to find the
  98. string.
  99.  
  100. At each place where the string is found, the current output file will
  101. be truncated, and a new file will be started. The files will be named
  102. 'file.001', 'file.002', etc. Caesura will create up to 998 files in
  103. this fashion, surely enough for anyone.
  104.  
  105. The radio botton group at the bottom of the dialog box tells Caesura
  106. where to effect the cut. If you are cutting at a common header, such
  107. as "Splendex Corporation 1992 Annual Report", you would select
  108. 'Divide at paragraph-ending BEFORE string'. If you are segmenting at
  109. a common footer, such as "See accompanying Notes to Consolidated
  110. Financial Statements", you would select 'Divide at paragraph-ending
  111. AFTER string'.
  112.  
  113. If you do not specify a string, Caesura will create a copy of your
  114. file.
  115.  
  116. When you hit the 'Start…' button, Caesura prompts you for a file to
  117. operate on. The new files will be created in the same folder, and the
  118. original file will not be altered in any way.
  119.  
  120.  
  121.  
  122. Caesura in real life...
  123.  
  124. If you find yourself using this a lot, I'd love to hear from you.
  125. Almost I talked myself out of doing it, so few were the uses I could
  126. think up for it. But here are a small few:
  127.  
  128. * If you have a job that comes in one enormous file, you can save
  129. yourself a lot of Mac-sluggishness by cutting it up into smaller
  130. chunks and working on those. If necessary, use one of my file
  131. concatenators (Catena or Cat o' Seven Tails) to put the pieces back
  132. together at the end.
  133.  
  134. * If you have a file that come in logically distinct segments, and if
  135. it behooves you to operate on those segments in logically distinct
  136. ways, Caesura will slice 'em up quick like. I'm thinking here of
  137. financial work, as an example, where the work to be done on the
  138. tables is largely different from the work to be done on the text.
  139.  
  140. * If you have a job that needs an exceptional amount of Torquemada
  141. intelligence, and if the Torquemada set is taking forever to run
  142. because each and every 'wildstring' used is going to the end of the
  143. buffer before it fails, it can be emeinently worth your while to
  144. segment the source file.
  145.  
  146. * Finally, if you are experiencing buffer-bounding errors using
  147. 'wildstrings' in Torquemada, these will go away if you use Caesura to
  148. cut your source file in segements 16K or smaller.
  149.  
  150. (The last two are best understood by reference to the manual that
  151. ships with the Torquemada release archive.)
  152.  
  153.  
  154.  
  155. Fair warnings...
  156.  
  157. * Caesura is 32-bit clean and System 7 compatible. It is not,
  158. however, System 6 hostile, nor does it support Drag & Drop (didn't
  159. make much sense, given that you _have_ to interact with it).
  160.  
  161. * If you speak with a lilt, a burr, a brogue or a twang, I will do
  162. my best to ignore your importunate feature requests in order to prove
  163. that I can (grin).
  164.  
  165.  
  166.  
  167. That's it. Happy cutting...
  168.  
  169. Greg Swann
  170.